home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / apps / astronmy / astrocal.arc / ASTROCAL.TXT < prev   
Text File  |  1985-11-20  |  20KB  |  521 lines
  1.  
  2.  
  3.          Cadenza AstroCal (Version 1.8, October 6, 1988)
  4.  
  5.  
  6. Program Features
  7.  
  8. This program generates (for any given year) a calendar  containing 
  9. the following information:
  10.  
  11. 1.   Times of sunrise, sunset, moonrise, and moonset for each day
  12. 2.   Times and dates of Moon phases
  13. 3.   Times and dates of solar and lunar eclipses
  14. 4.   Times and dates of solstices and equinoxes
  15.  
  16. In addition to this calendar, the program can generate:
  17.  
  18. 1.   A report of all lunar or solar eclipses for a range of years
  19. 2.   A report of planet viewing information for a specified year
  20. 3.   A  report  of  perihelions and aphelions  of  planets  for  a 
  21.      range of years
  22. 4.   A report of perigees and apogees of the Moon for a  specified 
  23.      year
  24. 5.   A report of the dates of Easter for a range of years
  25. 6.   A  diagram  of the positions of Jupiter's  bright  (Galilean) 
  26.      moons.
  27.  
  28. The  calendar  and  reports  are all  customized  for  the  user's 
  29. location.  All times and dates are in local time.
  30.  
  31. The calendar and reports can be printed on a printer or listed  on 
  32. the computer screen.
  33.  
  34.  
  35. Hardware Requirements
  36.  
  37. This program should run on any Atari ST computer with a monochrome 
  38. or color monitor.   This program runs on color monitors in  medium 
  39. resolution only (please see the Bugs section below).   Of  course, 
  40. users  wanting  to  print out calendars and reports  will  need  a 
  41. printer.
  42.  
  43.  
  44. Menus
  45.  
  46. AstroCal  has the following menus:  "Desk",  "Describe  Location", 
  47. "Generate Report", "File", "Display", and "Help".
  48.  
  49. The "Desk" menu can be used to run desk accessory programs, and to 
  50. see the "introduction box" of this program.
  51.  
  52. The "Describe Location" menu is used to specify one's location (in 
  53. latitude and longitude), and the difference between local time and 
  54. UT (universal time (sometimes called GMT (Greenwich Mean Time)).
  55.  
  56. The "Generate Report" menu has eight submenus:  "Calendar", "Lunar 
  57. Eclipses",   "Solar  Eclipses",   "Planet  View   Info",   "Planet 
  58. Distance",  "Moon  Distance",  "Dates  of  Easter",  and  "Jupiter 
  59. Moons".
  60.  
  61. The  "File"  menu has only  one  submenu,  labeled  "Quit".   This 
  62. submenu is selected to quit the entire program.
  63.  
  64. The "Display" menu has two submenus,  "Scroll" and "Stop".  If you 
  65. select the "Stop" submenu,  the program will wait for you to  type 
  66. the  RETURN key after each page of text is listed on  the  display 
  67. screen.   If you would prefer that the program continuously  write 
  68. text on the display screen without stopping,  select the  "Scroll" 
  69. submenu.   The  "Display"  menu does not affect  the  printing  of 
  70. calendars and reports on a printer.
  71.  
  72. The  "Help"  menu  is  used to get  basic  information  about  the 
  73. program.
  74.  
  75.  
  76. Getting Started
  77.  
  78. First  of  all  you will need to provide  the  program  with  some 
  79. information about your location and local time.   This information 
  80. is required to allow the program to customize its output for  your 
  81. location and time zone.
  82.  
  83. Select the "Describe Location" menu with the mouse.   Then  select 
  84. the "Describe Location" submenu.   At this point you should see  a 
  85. "dialog  box"  allowing  you to specify  your  city's  name,  your 
  86. latitude and longitude, and the difference between your local time 
  87. and UT.
  88.  
  89. Type  the name of your city in the space labeled "Location  Name".  
  90. Type  in  your latitude and longitude in the  appropriate  spaces.  
  91. Note  that  latitude  and longitude must  be  entered  as  decimal 
  92. degrees.   To convert an angle expressed in degrees,  minutes, and 
  93. seconds form to decimal degrees, use the following formula:
  94.  
  95. decimal degrees = degrees + minutes / 60 + seconds / 360
  96.  
  97. For  example,  if you know that your latitude is  32  degrees,  12 
  98. minutes,  and 44 seconds,  you will need to type in a latitude  of 
  99. 32.21 since:
  100.  
  101. 32 + 12 / 60 + 44 / 3600 = 32.21 (rounded)
  102.  
  103. If  you  live  north of the equator,  select  the  button  labeled 
  104. "North".  Otherwise select "South".
  105.  
  106. In  the same way,  enter your longitude in  decimal  degrees,  and 
  107. select the "West" button if you live west of  Greenwich,  England, 
  108. or "East" otherwise.
  109.  
  110. Finally,  enter  the  number of hours that you must add to  UT  to 
  111. convert to your local time.   If you must subtract from UT to  get 
  112. your  local  time,  enter  a negative number.   You  may  enter  a 
  113. fractional number (e.g. 4.5).
  114.  
  115. Users in the USA can use the following table:
  116.  
  117. Atlantic Time Zone                 Local Time = UT +  -4 hours
  118. Eastern Time Zone                  Local Time = UT +  -5 hours
  119. Central Time Zone                  Local Time = UT +  -6 hours
  120. Mountain Time Zone                 Local Time = UT +  -7 hours
  121. Pacific Time Zone                  Local Time = UT +  -8 hours
  122. Most of Alaska                     Local Time = UT +  -9 hours
  123. Hawaii Time Zone                   Local Time = UT + -10 hours
  124.  
  125.  
  126. Once  this  information  is entered,  select  the  button  labeled 
  127. "Done".   This  information  will be saved in a disk  file  (named 
  128. astrocal.dat) and need not be entered again.
  129.  
  130. Note  that  AstroCal gives all times and dates in  local  standard 
  131. time, never in Daylight Savings Time or Summer Time.
  132.  
  133. Now  that  you've specified your location,  you  can  generate  an 
  134. astronomical calendar or a report.
  135.  
  136. Note about entering years:   if you want a calendar or report  for 
  137. the year 1988, enter 1988, not 88.  Negative years (i.e. B.C.) can 
  138. be entered. 
  139.  
  140.  
  141. Generating an Astronomical Calendar
  142.  
  143. Select  the  "Generate  Report"  menu,  and  then  the  "Calendar" 
  144. submenu.   At this point you should see a dialog box allowing  you 
  145. to  specify the year of the calendar,  the starting month  of  the 
  146. calendar,  and  whether  the calendar should be  printed  on  your 
  147. printer  or  on  the computer  screen.   Once  you've  given  this 
  148. information,  press  the "Done" button,  and the calendar will  be 
  149. generated.   If  you change your mind,  press the  button  labeled 
  150. "Cancel",  and the calendar will not be generated.   Preparing  an 
  151. astronomical calendar will take about one hour.
  152.  
  153. The   calendar  will  contain  several  abbreviations  which   are 
  154. explained in the Abbreviations section later in this document.
  155.  
  156.  
  157. Equinoxes and Solstices in the Northern Hemisphere
  158.  
  159. The  celestial  equator  is the plane  described  by  the  Earth's 
  160. equator.   The ecliptic is the apparent path of the Sun across the 
  161. sky during one year.
  162.  
  163.  
  164. Equinoxes  occur when the ecliptic crosses through  the  celestial 
  165. equator.   At  the  March  Equinox the Sun appears  to  cross  the 
  166. celestial  equator on its journey north.   The  September  Equinox 
  167. happens  when the Sun crosses the celestial equator  going  south.  
  168.  
  169. Solstices  occur when the ecliptic is maximally north or south  of 
  170. the  celestial equator.   At the June Solstice the Sun is  as  far 
  171. north  of  the  celestial equator as  possible.  At  the  December 
  172. Solstice the Sun is as far south as possible.
  173.  
  174. Spring begins at the March Equinox,  Summer at the June  Solstice, 
  175. Fall  at  the  September  Equinox,  and  Winter  at  the  December 
  176. Solstice.
  177.  
  178. For the southern hemisphere,  switch north and south,  summer  and 
  179. winter, and fall and spring in the previous three paragraphs.
  180.  
  181.  
  182. Generating an Eclipse Report
  183.  
  184. Select the "Generate Report" menu with the mouse,  and then select 
  185. the "Lunar Eclipses" or "Solar Eclipses" submenu.   At this  point 
  186. you  should see a dialog box prompting you for the range of  years 
  187. of  the report,  and whether the report should be printed on  your 
  188. printer  or  listed on your display  screen.   Press  "Done"  when 
  189. you've entered all of the information, or press "Cancel" to quit.
  190.  
  191.  
  192. Interpreting a Lunar Eclipse Report
  193.  
  194. During a lunar eclipse,  all observers that can see the moon  will 
  195. see the same part (i.e.  moon enters shadow, maximum eclipse, moon 
  196. leaves shadow) of the eclipse at the same instant.   Thus for each 
  197. eclipse  in the eclipse report,  you will be able to view a  given 
  198. part of that eclipse if it occurs between the time of moonrise and 
  199. moonset on the day of the eclipse.
  200.  
  201.  
  202. Interpreting a Solar